To: LisA Software-, Hardware, Pubs & NPR, and Lisa Users 
From: Rich Page 

Ralph Sahm 

Ken Friedenbach 
Date : Apr i 1 11, 1983 
Subj : Release 12.0 of the Monitor Pascal Devlopment S/stem 



This release contains contributions from Bruce Daniels, 
Sussanah Lam, Chris Franklin, Al Hoffman, Fred Forsman and 
David Hough. Due to lack of space on the boot disk we were not 
able to also include lUFPLIB. This can be obtained separately. 

Overv i ew 



This release of the Monitor provides a mu 1 t i -programmi ng 
environment in which programs and exec files can be executed in 
either foreground or background. This release includes the Pascal 
compiler which supports Classses. This release also includes 
numerous- bug fixes. The loader has been enhanced to implement 
code remembering. The Monitor has been enhanced to remember 
directories. The user should notice a 2x to 4x improvement in 
system through put (ie. typical process launch is quite short). 
This release provides a viable Twiggy based development system. 

I nstal 1 at i on 



This release consists of a complete development system 
contained on a single Twiggy. Simply copy the contents of the 
Twiggy onto your root volume <ie. #5: of the working device) and 
reboot with the new boot disk. 



Notes : 



The files listed below in the section called Boot Files 
do not need to be copied to your root volume. 

The process above assumes that your root volume is named 
LISA:. If you have a volume named LISA: which is not your 
root volume you must have a copy of the Mouse Editor files 
and Font files on LISA 5. 

The In tr i nsi c .LIB on this release has been taken from A5.2.5 
The development system libraries <ie. lUPASLIBA: OBJIOLIB) 
are compatible with releases 10.2 and 11.x. If you wish to 
use a different In tr i nsi c .LIB remember to Install these 
files. 

If you wish to use this release with a Lisa 1.5 replace the 
CONFIG. DATA file with the file CONFIG! . 5 . DATA. 



D i rec tory 



Boot Files 



MON. LOADER 10 IS-Jan-SS 
CONFIG. DATA 1 30 -Mar -33 



FM*: REL12.0.TEXT 



BOOTFILES.DATA 


1 


21-Feb- 


-83 


LISABUG.OBJ 


63 


10-Apr- 


-83 


LISABUG2.0BJ 


29 


27-Feb- 


-83 


DRI^v'ERS.OBJ 


16 


23-Mar- 


-83 


MS. OB J 


5 


28-Mar- 


-83 


UARTDRVR . OBJ 


2 


23-Apr- 


-82 


LOADER. OBJ . 


64 


8-Apr- 


-83 


TWGDRVR? . OBJ 


4 


25-Mar- 


-83 


MONITOR. OBJ 


38 


10-Apr- 


-83 


MONITOR. SYMBOLS 


12 


10-Apr- 


-83 


CONFIGl .5. DATA 


1 


8-Apr- 


-83 


Stc^rt Up Fi les 









MON.MISCINFO 
MON . STARTUP 
MONSTARTl .OBJ 



1 12-Jun-80 
4 8-0ct-81 
3 4-Jun-81 



System Utilities 



FILER. OB J 


91 


6-Apr- 


-83 


SYSMGR.OBJ 


29 


6-Apr- 


-83 


MOlv^ESOROC.OBJ 


4 


7-Juri- 


-81 


CHANGEMEM . OBJ 


2 


1-Apr- 


-83 


MOUNT . OBJ 


4 


24-Sep- 


-81 


FORMATTER. OBJ 


12 


28-Mar- 


-83 


SHELL,. OBJ 


11 


lO-Apr- 


-83 


L 1 br ary & Li nk 


Files 


18-Nov- 




CALLS, OB J 


3 


-82 


LOADER. IMAGE 


1 


1-Jun- 


-81 


MPASLIB.OBJ 


48 


21-Jan" 


-82 


NOFPLIB.OBJ 


18 


21-Jan- 


-82 


INTRINSIC.LIB 


8 


8-Apr- 


-83 


OBJIOLIB.OBJ 


103 


6-Apr- 


-83 


lUPASLIB.OBJ 


15 


14-Feb- 


-82 


Devel opmen t Fi 1 


es 


8-Apr- 




COMPILER. OB J 


180 


-83 


PASERRS.ERR 


12 


7-Apr- 


-83 


CODE. OBJ 


103 


7-Apr- 


-83 


lULINKER.OBJ 


56 


10-Apr- 


-83 


LINKER. OBJ 


32 


8-Apr- 


-83 


N68K. OPCODES 


.8 


4"Feb- 


-83 


N68K.ERR 


6 


6-Apr- 


-83 


ASSEMBLER . OBJ 


80 


6-Apr- 


-83 


Development Uti 


Titles 


> 
28-Mar- 




BYTEDIFF.OBJ 


4 


-83 


CHANGESEG.OBJ 


3 


28-Mar- 


-S3 


CHANGETRAP.OBJ 


4 


3-Mar- 


-83 


CODESIZE.OBJ 


. 13 


S-Apr- 


-83 


D IFF. OBJ 


, 14 


28--Mar- 


-83 


DISKCOPY.OBJ 


11 


8-Mar- 


-83 


DUMPHEX . OBJ 


5 


8-Mar- 


-83 


DUMPO . OBJ 


8 


10-Jun- 


-81 


DUMPOBJ.OBJ 


35 


28-Mar- 


-83 
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FILEDIV^.OBJ 


16 


25-Feb- 


-82 


FILEJOIN.OBJ 


15 


25-Feb- 


-82 


FINDID.OBJ 


4 


8-Mar- 


-83 


FINDWORD.OBJ 


2 


a-Mar- 


-83 


GXREF.OBJ 


12 


8-Mair- 


-83 


I UMANA6ER . OBJ 


22 


28-M5ir- 


-83 


OBJDIFF.OBJ 


26 


2O-AU9- 


-81 


PACKSEG.OBJ 


12 


28-Mcir- 


-83 


PATCH . OBJ 


7 


8-Mar- 


-83 


PRINTSIZES.OBJ 


3 


18-Mair- 


-83 


REUSE. OBJ 


19 


8-Mar- 


-83 


SEGMAP . OBJ 


4 


8-Mar- 


-83 


SETSIZES.OBJ 


5 


18-Mar- 


-83 


SXREF. OMIT. TEXT 


4 


23-Sep- 


-82 


SXREF . OBJ 


10 


28-Mar- 


-83 


Edi tor Fi 1 es 


" 







EDITOR. OBJ 

ED IT. MENUS. TEXT 

PAPER. TEXT 

UCSDEDITOR.OBJ 

Font Files 



199 



-Apr -83 



6 22"Feb-83 

4 21-Jun-82 

71 8-Apr-83 



CENTURY 12R 12s. 


F 


3 


5-AUQ-82 


CENTURY12R10S. 


F 


3 


5-AU9-82 


CENTURY 12RPS.F 




3 


5-Aug-82 


FM.MN.HEUR 




2 


17-Jun-82 


SYSCURSORS.F 




4 


5-Auq-82 


SYSTEXTS . F 




5 


30-Sep-82 


TILE7R20S.F 




3 


5-AU9-82 


TILE12RPS.F 




3 


5-AU9-82 


TILE12R12S.F 




4 


6-AU9-82 


TILE7R15S.F 




2 


5-AU9-82 


WMFONTS.F 




8 


8-NOM-82 


Monitor Enhancemen 


ts 







The enhancements to the Monitor, boot and system files are 
as foil ows ! 



1) 



Fi 



REL12.0 .TEXT 



Low memory has been re-arranged so that release 3.5 of 
the Dr i Mens can be used. This results in a larger type 
ahead buf-fer <ie. back to 32 characters). 

At address *D00-^176 there is a pointer to the start 
o-f three 12 byte bu-f-fers. These buffers are used as 
■follows by the Twiggy driver: 

a) At <*D00-&176) there is a 12 byte bu f-fer for the 
header of the last block read by the twiggy dr i uer . 

b) At <*D00-&:176)+^12 there is a 12 byte buffer for the 
header of the next block to be written by the twiggy 
driver (for blocks 1 to 1701). This buffer is 
initialized to all zeros. 

c) At < *D00 -.:*<: 1 76) +^<24 there is a 12 byte buffer for the 
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header of' the next block to be written by the twiggy 
driver <for block only). This buf-Fer is initialized 
to a1 1 A's. 

3) When a -fatal error is encountered, the process filename 
and process number are displayed along with the error 
number. The user has the option to type <space> to 
continue <ie. back to prompt) or type <esc> to debug. 

4) The phantom <cr> problem has been fixed. Some programs 
le-ft the EOLN flag set, which would cause the next program 
to appear to see a <cr> before the user had a chance to 
type any i npu t . 

5) The M command now works for logical files. 

6) The cursor on the primary screen is a' black rectangle. 
The cursor on the alternate screen (except for 1 i sabug) 
is a gray rectangle. 



Multiple Programming 



The Monitor now allows programs and exec files to execute 
in the Foreground or the Background. These are defined as follows: 



Foreground 

Sup state Domain 

X command (from Monitor) 

Bl ock I/O i s Atomi c 

Old Physical JT above A5 

New Physical JT above A5 

Logical or lU JT above A5 

Same screen as Monitor prompt 



Background 

User state Domain 1,2,3 
B command (or X from Shell) 
not Atomj 

rra^phy 

fa Mom Phv 

or lU JT above A5 




Mj^ 



Defaults to the Alternate Screen 
Note: ACDEFGLSU behave the same as the X command. 



There are two new commands on the Monitor alternate prompt 
line. These are B for background and P for Process Mgr . 

The user can launch backgound processes via the B command. The 
B command prompts the user for three pieces of information as 
foil ows : 

1) Name of the file to execute (must be logically linked) 

2) Input file name . 

3) Output file name. 

The loader will open the predefined files INPUT Jk OUTPUT 
with the file names given by the user except as follows: 

"If the user types <cp> , CONSOLE: is used as the file name 
and the I/O is directed to the alternate screen. 

If the user types <esc>, CONSOLE: is used as the file name 
and the I/O is directed to. the primary screen. 

The number of processes is currently restricted to 4 in 
addition to the Monitor. Up to three processes can be 
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launched in the background prior to running a foreground 
process. Foreground proccesses are launched with the X 
command or an abbreviation o+* the X command (ie. A,C,E ...> 



The scheduling is round robin on the first call to the Monitor 
or the Drivers <ie. Trap #5 and l**E) after 100 ms has expired 
since the last scheduling took place. Most calls to the 
Monitor are atomic. Exceptions to this include block I/O to 
any file and unit I/O to units 1 and 2. 

The ProcMgr currently consists of only three commands: 

1) Fdush- 

Allows the user to flush all remembered code. 
Normally, this should not be needed. 

2) L<ist 

Lists the active processes. 

3) Q<uit 

Returns to Monitor prompt line. 

Note: The debuggers RM command returns to Monitor and kills 

the current user process. If RM causes a trace display 
rather then returning to the Monitor then you should 
type G <cp> and try NMI RM again (or use RB for Reboot). 

Launching Exec Files in the Background 

To launch an exec file in the Background execute the Shell 

program with the B command and enter the name of your exec 

file in response to the Input prompt and Type <cr> to the 
ou tpu t promp t . 

Note: If you wish to terminate the Shell upon completion 
of the exec file you must include a Q for Q<uit to exit the 
she! 1 . 

Note: Someday the above will be available as B execf i 1 ename . 

Error Summary 



Loader Errors 



Unknown segment 

1 No room in memory 

2 Bad block 

3 Can't read code file 

4 Jump Table Overflow 

5 N.A. 

6 N.A. 

7 Too many un i ts 

8 Bad un i t number 

9 No In tr i nsi c .LIB f i 1 
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10 No unit location table 

11 No segment location table 

12 Can^t open intrinsic library -1= i 1 e 

13 Can-'t read -file names block 

14 Bad segment number 

15 No unpack translation table 

16 Bad unpack uersion or unpack -failed 

17 Can't load physical in. the background 

18 Can''t make process out o-f memory or domain 

19 Can''t open Input or Output file 
*20 No lULoader 

*21 Too many object files 

*22 Too many programs 

*23 Too many code segments 

*24 lULoader bug 

*25 Squeeze failed 

*26 CALLSIPI returned 

*27 Resolve failed 

*28 GetAHeap failed 

29 Size Unpacked > 32767 

*30 GetAStack failed 

Note: Errors marked with * should not happen 

Fatal Errors 



Illegal index to Trap handler 

1 Stack overflow 

2 Program hal t 

3 Range value error 

4 Illegal string index 

5 Can''t read Root volume 

6 Can't grow the heap <ie. out of memory) 

7 Can't get space for directory 

DynStack, MaxStack, l^inHeap, MaxHeap 

The fields Maxstack and Maxheap are not enforced by the 
Monitors memory manager. Maxstack is currently limited to 128k. 
MaxHeap is limited by available physical memory. Approximately 
826k is available for code and data. If a program needs more 
or less stack or heap than the linker defaults provide <123k each) 
use the SetSizes utility (see below). 

New Utilities 

ChangeMem 



Can be used to modify the memory volume: 

1) create #4: Type new size 

2) grow the size of #4: Type new size 

3) flush #4: Type -1 

Notes : 
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1) Shrink is currently not implemented. Use Flush. 

2) Memory volume created by ChangeMem is limited 
to 128k bytes <ie. 256 blocks). 



Pr i n tSi zes 



Allows the user to see the current settings for the 
■Fields: DynStack , Max Stack, MinHeap and Max Heap. 



Se tS i zes 



Allows the user to adjust the stack and heap sizes 
<ie. DynStack, MaxStack, MinHeap and MaxHeap) in the 
Executable block. 



Shel 1 



Monitor shell look alike which can be run in the . 
background to launch other programs in the background. 

Compiler, Assembler, Linker, Editor, ... Enhancements 



1) The Assembler has been modi-fied to use ObjIOLib tor output. 
This has removed the intermittant bugs -for large programs 
caused by reading and writing .CODE -file formats. 

2) The Assembler no longer uses any temporary files -for patching 
forward references. The internal code buffer has been opened 
up to 32 K. 

3) A .SEG directive has been added to specify the segment name. 
With this directive, assembler language modules can be placed 
to different segments without using the ChangeSeg Utility. 

Ex amp 1 e : 

.SEG "FooBar" 
. PROC XXX 

Th i's will place the PROC XXX (and all succeeding PROCs and 
FUNCs) in the segment named FooBar. 

4) The ChangeSeg util ity can now be used to change the 
segmentation of units without recompiling. The previous 
constraint (it only worked on assembly files) was relaxed. 

5') A Pre t tyL i st op t i on has been added for back substituting 

forward references in the assembly 1 anguage 1 i st i ng . This 
replaces the Pretty List utility program. 

6) The compiler and code generator now support Classes. If you 
use Classes or units which contain Classes, then you must link 
with the file " CALLS . OBJ'' . There are some new compiler errors 
relating to classes. See the Classcal reference manual for 
further de ta i 1 s . 
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7) The compiler no longer prompts -for the debugger output file. 

8) PackSeg was enhanced to support both the O.S. packing strategy 
<one per system) and the Monitor''s packing strategy (one per 
■file). It now asks whether you want to read the pack table 
<or compute it). And whether you want to write the pack table 
into each -file (or not). PackSeg will then accept a list o-f 
■files to pack, terminated with a <cr> » 

9) The Compiler and I UL inker now accept alternate speci-fications 
■for which In tr i nsi c .L i b to read as data. These options are 
invoked by typing ■«-W to the Input prompt of the lUl inker or 

? to the Input prompt of the Compiler. This is useful 
when bootstrapping to architectures which are not upwards 
compat i b1 e . 

10) The Compiler and Code generator were modified to add "Father" 
information in the debug information ( **D-*- *) so that LisaBug 
could handle the many dup 1 i cate names generated by Classes. 

11) The editor has been enhanced significantly as follows: 

a) UNDO and COMMAND-X , COMMAND-C , and COMMAND-^ . 

b) Printing is now available. 

c) Grows the heap as needed. 

d) Duplicate is now available. 

Debugger Enhancements 



a) The display memory commands (ie. DM,DW and DL) 
have been modified to use word moves. The 
display bytes command (ie. DB) still uses byte 
moves and allows use of odd addresses. 

b) The set memory commands (SW and SL) have been 
modified to use word moves. The set memory 
and set bytes commands (ie. SM and SB) still 
use byte moves and allow use of odd addresses. 

Note: For both display and set memory, if a 
word operation is appl i ed to an odd the address 
then the address is rounded down to the nearest 
word address. 

c) There is a new command CS (clear screen). 

d) The process number is now displayed. 

e) Break points can be of the form processnumber : address . 

f) There are five new commands for the printer. 

PR expr Pr i n ter 

The PR command enables or disables printing to 
the two port card. 

expr = 2 enable printing upper port 
expr= 1 enable printing lower port 
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expr = disable printing 

Note: while printing is enabled all debugger output 
to the screen is echoed to the printer. 

PS expr Print Screen 

The PS command dumps, the entire upper or lower screen. 

expr = 1 print primary screen 
expr = print alternate screen 

Note: li printing is disabled then nothing will 
happen . 

FF Form Feed 

The FF command sends a -form -feed to the printer i-f 
printing is enabled. 

PL Pr i n t bug repor t V i a lower port 

PU Print bug report uia upper port 

The PL and PU commands dump a "bug report" to the 
printer. The bug report consists of the following: 

Dump of the primary screen. 

Dump of the alternate screen <0S only). 

Form Feed. 

Description of exception. 

Trace display. 

Stack crawl . 

Disassemble of 20 lines from PC-*20 . 

Display words from RA6-S20 for $80 bytes. 

Form Feed. 

^ Note: after a PL or PU command, printing is left 
d i sabl ed . 

g) There are two commands which allow the user to dump 

all of memory to the upper or lower Twiggy as follows: 

ML Memory dump to the lower Twiggy drive. 
MU Memory dump to the upper Twiggy drive. 

The ML and MU commands behave as follows: 

1) If there is a disk in the drive when the command 
is issued the di sk e Jec ted . 

2> The user is prompted to insert a disk in the 

appropiate drive. For example, the ML command will 
cause the prompts- 
Please Insert Disk in Lower Drive. 

3) After the disk is inserted the command proceeds as 
toll ows : 

a) CI amp the d i sk . 
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b) Format the disk 

c) Bad block scan the disk 

d) Write block zero with debugger label 

e) Dump the MMUs for all domains 

i) Dump the -first 860k bytes o-f memory, 

g) CI ose the files, 

h) Eject the disk. 

Note: If everything goes ok the debugger prints the 
message : 

Memor y dump c omp 1 e t e . 

Note: If the process fails at some point the user will 
get an obscure message something like: 

Floppy Disk Error XX 

Note: The entire process takes about 3 1/2 minutes. 

h) The commands for clamping and unci amp ing the disk were 
removed many months back when the world of Twiggy and 
ROMs was changing. So we now have the following commands 
once aga i n : 

DU expr Disk unci amp. This will issue an unci amp 
to the drive. Use 1 for the upper drive 
and 2 for the lower drive. 

DC expr .Disk clamp. This will issue a clamp to 

the drive. Use 1 for the upper drive and 
2 for the lower drive. 

i> Two commands have been added to allow a memory dump to 
be retrieved. The new commands are as follows: 

RL Retrieve memory dump from lower Twiggy. 
RU Retrieve memory dump from upper Twiggy. 

Theses commands are intended to be used as follows: 

1) Enter Lisabug and insert the disk into either 
drive. Issue the appropiate command RU or RL . 

2) The debugger first attempts to validate the disk. 
If everything looks ok <at first glance) then 

the debugger will reload memory and MMU registers 
from the d i sk . 

3) From here you can look around all you would like. 

4) I would not recommend Trace, Go or RM unless you 
areveryclever. 

Note: When the MMUs and memory are reloaded from disk the 
following is left untouched. 

1) In domain zero the first 16 MMUs and the last 
3 MMUs <ie. 125,126,127) are not loaded. 
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2) Memory -from to *1800 is not loaded -from disk. 

3) Memory above *D3800 is not touched. 

Note! The disk built by the memory dump will look as -follows: 



MEMDUMP ! 
MMU . DATA 
MEMORY . DATA 



4 22-Feb-83 6 
1692 22-Feb-83 10 



512 Data-file 
512 Data-f i 1 e 



These -files can also be looked at with Dumphex i -f you like. 
Memory is a straight image -for now <ie. no packing yet). 
The MMUs are dumped domain segment -first and domain 3 
segment 127 last with 2 words per segment. The -first word 
contains the origin and the second word contains the control 
and limit registers. 



Memory, Uol ume 



The memory volume is currently not created at boot time. 
A-fter booting, a memory volume can be created with the ChangeMem 
utility. The option still exists to have a memory volume created 
at boot time. To create a memory volume at boot time patch the 
desired size in blocks into the longint located at *50 in the 
-file CONFIG. DATA. Memory volumes created at boot time provide 
a space which is locked down. The mefnory volume created at boot 
time is not limited by the 128k restriction which applies to the 
memory volume created by ChangeMem. 

Bugs Fixed 



The bug -fixes -for the Monitor, boot and system -files are 
as -fol 1 ows: 



1 ) 



2) 



3) 



4) 



5) 



6) 



7) 
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The' printer (on port &:3) is no longer trashed by the 
changing o-f screen contrast. 

During boot the Monitor pulls on keyboard reset so that 
the drivers get the correct keyboard id. 

Loader error #5 no longer appears. The loader now 
relocates the jump table -for physically linked programs. 
This allows the user to move the de-fault stack pointer 
(within reason) and still run the physically linked 
program . 

The DLE expansion problem has been -fixed -for the printer 
when attached to the parallel port. 

The Monitor no longer crashes a-fter the user program 
encounters fatal errors (ie. range check, ...). Fatal 
errors also stop exec files now. 

Boot disks can now be copied with volume to volume 
transfer (ie. boot blocks remain intact). 

First character after an exec file stopped was printed 
twice for some exec files. This has been fixed. 
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8) Exec files are stopped \i EOF is encountered. 
Cautions 



Notes: 



1) The program SETSP should not be used with this release. 

2) Programs which are to be launched in the background 
must be linked logical. 

3) While any other processes are accessing a given volume 
do not attempt the -following: 

a) Krunch the volume 

b) Zero the directory itp that volume 

c) l^anage that volume with the vl^^gr 

d) Format i t 

e> Unmount the device the volume i s on 

4> Older vers! on s of the system utilities should not be 
used with this release. 



1) When a process terminates it will cause the Monitors 
prompt line logic torestart if there is no foreground 
process active. This means that exec files should not 
be run in both the foreground and the background at 
the same time. Hopefully this bug will be removed by 
next release. 
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